The PC Weasel 2000 


Making servers run headless since 1999. 


Addendum 1 to User Documentation - Version 1.01 Beta PC Weasel 2000 


Addendum to PC Weasel 2000 User Manual Version 1.01 Beta 


1. Section 2.1 Jumpers and connectors 


Replace Figure 1 with the following diagram: 


JP 1 JP3 P2 


Figure 1: PC Weasel Board Diagram 
1.1. Section 2.1.2 P1 -Local reset input 
P1 is now the ISA edge connector, formerly P6. 
1.2 Section 2.1.6 P6-ISA edge connector 
P6 is now the local reset input, formerly P1. 
1.3. Section 2.1.7 JP1-Memory Map and Safe-boot Jumpers 
JP1 has been redesignated the “Startup Jumper” header. The positions marked “0” and “1” 
function as described in the manual, determining the board’s behaviour on startup. One more 


position has been added, marked “2”. 


When a jumper block is placed in position ‘2’ of JP1 before power-on or reset, the PC Weasel 
operates in “Safe Boot Mode”. 
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In “Safe Boot Mode”, the PC Weasel ignores its configuration settings and instead uses the 
default factory-programmed configuration: 


1.4 Section 2.1.8 JP2 


Weasel Attention Character: Oxle (“) 
Baud Rate: 9600 

Parity: none 

Databits: 8 

Pass-through: NO 

Hardware Flow Control: NO 

Allow Watchdog: NO 

Pass <BREAK> to 16550: NO 


- Keyboard ground 


The “keyboard ground” function has been eliminated in Revision 1.1. JP2 is now a set of eight 


pads reserved for factory use. 


2. Section 3.2 PC Weasel Configuration 


2.1 Section 3.2.6 Serial Pass-through 


Valid options for the “Serial Pass-through” configuration attributes are “YES”, “NO”, and 
“AUTO”. The default is “AUTO” 


2 of 2 


AUTO -- If Serial Pass-through mode is set to “AUTO”, the PC 
Weasel will monitor the 16550 UART for activity, and upon 
detecting a character output from the 16550, the UART will exit 
Emulation mode and begin relaying characters between the 16550 
UART and the RS-232 connector. 

Conversely, if the PC Weasel is operating in Serial Pass-through 
mode and detects data written to the video buffer, it will discon- 
nect the 16550 UART’s serial I/O and switch back to Emulation 
mode. 

YES -- If Serial Pass-through mode is set to “YES”, then the PC 
Weasel will immediately exit Emulation mode and begin relaying 
characters between the 16550 UART and the RS-232 connector. In 
the event that the PC Weasel detects data written to the video 
buffer, it will continue to remain in serial pass-through mode. 

NO -- If Serial Pass-through mode is set to “NO”, the PC Weasel 
will ignore activity on the 16550 UART and remain in Emulation 
mode. 
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PC Weasel 2000 


Contact Information 


Web Server 

FTP Server 
Demo System 
Technical Support 
Sales 
Documentation 


(Comments/Corrections) 


Mailing Address 


Street Address 
(Courier only, not postal mail) 


Vox 


Fax 


http://www.real weasel.com/ 
ftp://ftp.realweasel.com/pub/realweasel/ 
telnet://demo.realweasel.com 
support@realweasel.com 
sales@realweasel.com 


docs@realweasel.com 


Canada Connect Corporation 
PO Box 2621, Station M 
Calgary, Alberta, Canada 
T2P'3€1 


#403, 1300 8th Street SW 
Calgary, Alberta, Canada 
T2R 1B2 


403-705-2025 
403-705-2026 


Documentation Revision History 


First release: 1.00 December 16th, 1999. 
Minor corrections: 1.01 February 12th, 2000. 
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1. Introduction 


The PC Weasel 2000 is the mutant bastard child of Big Blue, open-source computing, and an 
inbred mass-murdering hillbilly. Depending on your point of view, it's either: a) a video board 
with serial output instead of a monitor and a keyboard with serial input instead of keys, or b) a 
serial board that emulates a video board and a keyboard. 


It has been designed to address a fundamental shortcoming in the majority of readily-available, 
low-cost, high-performance PC motherboards: The lack of a means of remote administration via 
serial I/O, mainly at the BIOS level. 


The PC Weasel is a single-slot 8-bit ISA board that emulates the PC keyboard and the original 
IBM MDA (Monochrome Display Adapter) character-based video board. Plugged into an 8-bit 
or 16-bit ISA slot, it receives the characters written by the host CPU into its "video" memory, 
converts them to serial data suitable for display using VT-100 (or other) controls, and transmits 
them out the onboard RS-232 port. Characters received from the user by the RS-232 port are con- 
verted into keyboard scan codes and output by the PC Weasel to the motherboard's keyboard con- 
nector. 


The PC Weasel also provides supervisory functions. The user can manually reset the PC via com- 
mands issued to the PC Weasel's onboard controller. The user can activate a watchdog timer 
which will automatically reset the host PC if the PC fails to periodically service the watchdog. 
Host PC BIOS POST (Power On Self Test) codes are also capture by the PC Weasel to aid in the 
remote debugging of crashed systems. 


Designed by real-world systems administrators, everything about the PC Weasel is intended to 
make the admin's life better. The board is highly user-configurable. Both onboard microcontrol- 
lers use flash code stores, allowing the user to to update the PC Weasel's firmware in-system, 


remotely, and without risk of crippling the board should the upgrade fail. 


Run headless. 


The PC Weasel 2000 is US and Canadian patents pending. 
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2. Installation Guide 
2.0 Introduction 


This section describes the functions of the PC Weasel's connectors and configuration jumpers. 
It is intended to be read by the user who normally considers manuals to be extraneous packing 
material. 


2.1 Jumpers and connectors 
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Figure 1: PC Weasel Board Diagram 


2.1.1 Jl - AT keyboard emulation output 


This 6-pin mini-DIN jack provides the AT-keyboard emulation output from the PC Weasel. It 
should be connected to the PC motherboard's keyboard input jack using the cable provided. Ifthe 
motherboard is equipped with a 5-pin 180 degree DIN connector, an adapter (not supplied) will be 
required. See also “2.1.8 JP2 - Keyboard Ground”. 


2.1.2 Pl - Local reset input 


Normally not used. 
If the user wishes to write/debug PC Weasel code, a normally-open push button switch (not 


supplied) may be connected to this header in order to provide a reset to the onboard CPU. The 
external switch closure is debounced by the PC Weasel's circuitry. 
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2.1.3 P2 - Local debug RS-232 port 


This header provides access to the PC Weasel's RS-232 debug port, which is the 68HC11's Serial 
Communication Interface, or SCI. When operating, the PC Weasel code logs stderr debug 
messages to this port, and when BUFFALO (the 68HC11 ROM monitor) is invoked it also uses 
this interface. This port operates at 9600 baud. 


A ribbon cable as described in Figure 1 may be connected to provide a PC-compatible DB-9P 
connector. TxD, RxD, and Ground are the only signals provided on this interface. See also "2.1.7 
JP1 - Memory Map Jumpers". 


Pin 1 Pin 1 Header | DB-9P | Function 
1 1 NC 
2 6 NC 
3 2 RxD 
4 Hh NC 
5 3 TxD 
| ee eee ee 
6 8 NC 


10 pin .1" 
Female (Soom aes nae ee et 
Header 8 9 NC 


3 


(Connectors shown with "business end" facing reader.) | 7 __|__-__| "=" 
N/A N/A 


—_ 
oO 


Figure 2: Debug Cable 


2.1.4 P3/P4 - PC reset in/out 


These two header connectors allow for connection to the PC's reset circuit. The PC Weasel's reset 
circuit provides a mechanical relay contact closure, so the connection to the PC is orientation- 
insensitive. The user should disconnect the PC's reset switch from the motherboard, connect it to 
one of the PC Weasel's reset connectors, and connect the PC Weasel to the motherboard's reset 
input using the supplied cable. P3 and P4 are wired together in parallel; it doesn't matter which iS 
connected to the reset switch and which to the motherboard. The center pair of pins may also be 
used. 
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AHHH} 


P3 P4 


Figure 3: PC Reset Header 


2.1.5 PS - Console RS-232 port 


This DB-9P connector provides the user console. This port is fully compatible with standard PC 
serial ports. Video emulation data is transmitted out as serial data, and serial data received is 
converted into AT-keyboard scan codes to be input to the PC motherboard's keyboard connector 
via "Jl - AT Keyboard Emulation Output". 


Modem controls have been supplied to facilitate sensing and manipulation of individual modem 
control signals on this port whether or not the board is operating in video-emulation mode. See 
"5.2.6 - Modem Register". 


2.1.6 P6- ISA edge connector 


This edge connector plugs into the PC's ISA bus. 


2.1.7 JP1 - Memory Map Jumpers 
Normally not used (ie no shorting blocks installed). 
These jumpers perform dual functions. One is to alter the positions of selected memory resources 
within the PC Weasel’s internal address space. The other is to choose the code to be executed on 
startup (eg: bootloader, debug monitor, or other). See "5.1 Memory Map". 

JP1 


MEMORY 
MAP 


Figure 4: Memory Map Header 
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2.1.8 JP2 - Keyboard ground 


Normally not used (ie no shorting block installed). 


This jumper enables connection of the PC Weasel's DC ground to the keyboard connector (J1) 
ground. If the keyboard output is being connected to a computer other than the one that the PC 
Weasel PCB is plugged into, this jumper should be installed. 


a) 


KEYBOARD 
GROUND 


Figure 5: Keyboard Ground Header 
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2.1.9 JP3 - 16550 UART ISA address 


These three jumpers inform the ISA decoding logic of the desired address for the 16550 UART. 
The jumper block is organized as follows: 


The presence of jumper block is a “1”, the absence of a block is a “0”: 


Jumper UART 
Setting Address 
0 disabled 
JP3 | (no jumpers) 
UART ——S 
Bit Value l Ox3f8 
eS 8 2 Ox2£8 
1 O 0 2 3 0x3e8 
0 oO 0 1 4 0x2e8 
5 unused 
6 unused 
| 7 unused 
(three jumpers) 
———— 


Settings noted as "unused" are available for configuration as non-standard addresses. 


Figure 6: UART Address Header 


2.1.10 JP4 - 16550 UART ISA interrupt 


This jumper connects the 16550 UART's interrupt output to the desired ISA interrupt line. 
IRQ 


JP4 
Figure 7: UART ISA Interrupt 
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3. PC Weasel User’s Guide 


3.0 Introduction 


This section describes the PC Weasel's operational interface and configuration options. While the 
operating controls are simple, low-risk, and largely self-explanatory, special attention should be 
paid to the caveats accompanying the configuration control information. Due to the nature of the 
PC Weasel's design and intrinsic flexibility, there are configuration options and combinations of 
configurations that offer traps to the unwary. 


The PC Weasel employs two code stores: A ROM bootloader and FLASH memory partitioned 
into four blocks for the board's operating code. When the PC Weasel is powered up (or reset) the 
bootloader reads the header of each FLASH partition, determines which (if any) contain boot 
images, and which (if any) is marked as the "default boot" image. This information is presented 
to the user via the console port as shown in Figure 8. 


The bootloader then proceeds to count down approximately five seconds, during which the user 
may type <return>, <esc>, or <nothing at all>. 


Typing <return> will truncate the five second countdown and cause the PC Weasel to 
immediately boot the default image. 


Typing <esc> will invoke the bootloader's FLASH programming routines, preparing the PC 
Weasel to accept a new operating image from the user as described in “Section 4.3 - Loading a 
new FLASH image into the PC Weasel". Should <esc> be typed inadvertently, the user may 
simply type <return> to boot the default image (as though <esc> had never been pressed) or 
specify booting a non-default image. 


Typing <nothing at all> will cause the PC Weasel to boot the default image at the conclusion of 
the five second countdown. 


Weasel Bootloader version: $Revision: 1.45 $ 


D1 - PC Weasel V1.00 
2 


3 - 
4 - 
Booting: C1 - PC Weasel V1.00] 


i ESS hO Baris Bae D reeds wuts oak i34 


Figure 8: PC Weasel bootloader on startup 
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Figure 9 shows the PC Weasel in normal emulation mode. If it looks no different than a PC that's 
just booted DOS, that's the whole point. You see what you normally would via a video board and 
CRT; characters typed by you are converted to AT scan codes and sent to the PC. 


System Configuration (C) Copyright 1985-1991, American Megatrends Inc., 


Main Processor : 80386 Base Memory Size 
Numeric Processor : Present Ext. Memory Size 
Floppy Drive A: : 1.44 MB, 3=" Hard Disk C: Type 
Floppy Drive B: ¢ 1.2 MB. S<” Hard Disk D: Type 
Display Type : Monochrome Serial Port(s) 
ROM-BIOS Date : 07/07/91 Parallel Port(s) 


64 KB CACHE MEMORY 
Starting MS-DOS... 


c:\o0 


Figure 9: PC Weasel in normal emulation mode 


3.1 Commands 


Normally, the PC Weasel works transparently, passing characters back and forth between the user 
and PC. In order to communicate local controls to the board, the user must send the PC Weasel a 
specified "Attention Character". This character is factory-configured as ASCII Oxle 
(<control><”> or <control><~>), but may be altered by the user (see 3.2.3 - Weasel Attention 
Character). 


Upon receipt of the Attention Character, the PC Weasel will respond by prompting the user for a 
command, as shown in Figure 10. 
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(C) Copyright 1985-1991, American Megatrends Inc., 


Main Processor : 80386 Base Memory Size : 640 KB 
Numeric Processor Present Ext. Memory Size : 7168 KB 
Floppy Drive A: : 1.44 MB, 3=" Hard Disk C: Type : 47 
Floppy Drive B: : LZ MB. O<" Hard Disk D: Type : None 
Display Type Monochrome Serial Port(s) ¢ Sr 
ROM-BIOS Date 07/07/91 Parallel Port(s) * 38 


64 KB CACHE MEMORY 
Starting MS-DOS... 


Ces 


Figure 10: PC Weasel Attention Mode 


At this point the user may issue one of the commands described in the remainder of this section, 
or press <?> or <h> and be rewarded with a help screen as shown in Figure 11. 


C Weasel €? for help}: § 
| System Configuration (C) Copyright 1985-1991. American Megatrends Inc., 


Main Processor : 80386 PC Weasel Help 
Numeric Processor : Present P (v1.00) 
Floppy Drive a: : 1.44 MBL 3=" 
Floppy Drive B: ¢ 2,2 MBL 5<* 
Display Type : Monochrome 
ROM-BIOS Date : 07/07/91 


Reset button in 
Reset button out 
Reset PC 

Reset Keyboard 
this screen 

set KBD status 
redraw display 
Send key to PC 
Configuration 
Message Buffer 
Last POST byte 
reboot PC Weasel 
1-9,0,-,= Func. keys 


64 KB CACHE MEMORY 
Starting MS-DOS... 


Cok? 


> 
QADTBOXTFXIXFDOK 


Any key to dismiss, 


Figure 11: PC Weasel Help Screen 
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3.1.1 PC Reset operations - ior 


Assuming the PC Weasel's reset connectors have been properly connected to the PC motherboard 
(see 2.1.4 - P3/P4 PC reset in/out), these commands allow the user to manually reset the PC 


Issuing an <r> ("reset") will cause the reset to be asserted for a period of 500mS, then released 


Issuing an <i> ("in") will cause the reset to be asserted and held in the asserted state until the user 
issues an <o> ("out") command, releasing the reset and allowing the PC to boot. This allows an 
admin to take the machine offline by brute-force means and keep it there indefinitely. It should be 
noted, however, that in this case quitting to ROM will release the reset regardless of the setting of 
“Reset PC on boot” (see 3.2.5) configuration option. 


3.1.2 Get KBD status - “x 


This command queries the keyboard emulation engine as to its state. This is primarily useful for 
debugging system problems, and will not be of much interest if the system is behaving itself. 


Possible responses are: 


- Keyboard: Normal 

- Keyboard: Busy receiving 

- Keyboard: Busy transmitting 

- Keyboard: PC aborted during transfer 

- Keyboard: PC didn't ACK (keyboard cable disconnected?) 
- Keyboard: PC busy 

- Keyboard: SPI write collision 

- Keyboard: AVR busy 

- Keyboard: Unknown AVR status 


3.1.3 Redraw display - / 


This command causes the PC Weasel to redraw the display. This is useful in the event that the 
display becomes out of sync with the PC Weasel MDA emulation due to line noise, etc. 


3.1.4 Send key to PC - x 


It will occur to the astute reader that not all of the keys available on the standard PC keyboard (eg. 
<alt>) are represented on the keyboards of ASCII terminals, workstations, etc. The PC Weasel 
addresses that shortcoming by allowing the user to send a specific key or combination of keys to 
the PC using a mnemonic scheme. Though it may seem at first glance to be excessively verbose, 
it's actually both easy to remember and natural to use. 
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However, it is important at this point to understand the nature of the PC keyboard. Specifically, 
keys that are normally thought of as "modifiers" (<shift>, <control>, and <alt>) for other keys in 
fact generate their own output codes even when vot used in conjunction with any other keys. 
Thus, in order to comprehensively emulate the PC keyboard's behaviour, the PC Weasel provides 
for the use of these keys in both contexts - either as modifiers or alone. 


Upon entering the PC Weasel's Attention Character and the (send key to PC) command <x>, the 
user will be prompted for the key(s) to be output. 


Outputting single keys: 


Figure 12 lists the supported keys and their associated mnemonics. Typing the mnemonic will 
output the appropriate key code to the PC. Only one key may be output per operation. Entering 
the mnemonics for more than one key will return an error message. 


EXAMPLES: 
To send <NUM LOCK>, type: 
<Attention Character> <x> <n> <u> <m> <I> <k> <return> 
To send <Page Up>, type: 
<Attention Character> <x> <p> <g> <u> <p> <return> 
To send <Left Shift>, type: 


<Attention Character> <x> <I> <s> <h> <i> <f> <t> <retum> 
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Cursor Keys 


Left arrow 


down Down arrow 
Right arrow 


Ictrl 
lalt 


Up arrow 


Delete 


pgup Page Up 
pgdn | Page Down 


Figure 12: Keycode mnemonics 


Outputting key combinations: 


Figure 13 lists the mnemonics for the <shift>, <control>, and <alt> keys as appropmiate for their 
use as modifiers - that is, in conjunction with the keys listed in Figure 12. 
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CAVEATS: 
The hyphens shown constitute part of the mnemonic. 
The modifier keys are case-sensitive. 


Any number of modifier keys (from one to six) may be used at a time to modify the key being 
sent. 


EXAMPLES: 
To send <Left Shift><Function 12>, type: 
<Attention Character> <x> <S> <-> <f> <1> <2> <return> 
To send the ever-popular Three Finger Salute, type: 


<Attention Character> <x> <c> <-> <a> <-> <d> <e> <I> <return> 


Modifier Keys 


Left Alt 


Figure 13: Modifier key mnemonics 


The <x> command will also accept a <?> and return the help screen shown in Figure 14. See also 


"dy 


3.1.5 - Function keys". 
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C? for helpl: 


Key help: 
Right Shift, Control, Alt: s-. c-, a- 
Left Shift. Control, Alt: S-. C-. A- 


Key Names: 
F - » FB KP2 4 NUMLK j ENTER 
KPS Pie LEFT TAB LALT 
< DOWN ESC LCTRL 
SPACE 
MINUS 
CAPSLK 


Figure 14: Keycode help screen. 


3.1.5 Function keys - /-9,0,-,= 


This is a shortcut mechanism for sending function key scancodes to the PC. Figure 15 describes 
the user-key-to-function-key mapping. 


Function 
output 


Fl 
BZ 


aw 
eo 


| 


| 


Wn} Be] b2} dO] 
Ty es) 
GN Ww 


Ty 
OV 


ie 5| 
~) 


H 


ry 
oo 
ahces 


E9 
F10 
Fll 
Fi2 


O}O]0}} Oo 


II 


L 


Figure 15: Function key translation 
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3.1.6 Configuration -c 


The PC Weasel maintains user-customizable configuration information in (nonvolatile) 
EEPROM. This command invokes the configuration menu, allowing the user to change selected 
parameters. The configuration menu is exited by pressing the <esc> key, at which time any 
changes made are committed. 


3.1.7 Message Buffer - m 


Some PC Weasel device drivers supply warning or error messages. These messages are logged in 
a [Kbyte ring buffer. The contents of the message buffer - the most recent 1024 bytes logged - 
can be viewed using this command. 


These messages are also transmitted out the debug serial port (see “2.1.3 - P2 - Local debug 
RS-232 port”), should the user choose to wire it up. 


3.1.8 Last POST byte - p 


When a PC exits reset and executes the contents of its BIOS PROM, the startup sequence 
generally includes a number of hardware diagnostic tests. At the beginning and end of each test a 
byte (the "Power On Self Test", or “POST” byte) is output to port 0x80 indicating the progress of 
the tests. 


Should a test in the sequence fail, the sequence is halted and the last byte written to the POST port 
remains as an indicator of the cause. The PC Weasel monitors ISA writes to this port and retains 
the most recently written byte for the user’s viewing pleasure. The last byte written in a 
successful startup will normally be 0x00. If this is the case, the <p> command will return the 
word "Nothing". 


NOTE: POST codes are specific to the BIOS manufacturer. The user should consult the BIOS 
manufacturer's documentation for an explanation of the host system’s POST codes. 


3.1.9 Quit to ROM - g 


“cy 


As explained “3.0 - Introduction”, the PC Weasel contains two separate nonvolatile code stores: 
The non-user-modifiable UV EPROM containing a bootstrap loader, FLASH programming 
routines, diagnostics, etc., and the in-system user-modifiable FLASH containing the operating 
software proper. When the PC Weasel's CPU is reset, either on power-up or manually (see “2.1.2 
- P1 - Local reset input’), it is the bootloader EPROM that is jumped to. 


This command allows the user to force the PC Weasel to begin execution of the bootloader 
EPROM code as though it were just reset. This is primarily useful to those developing code for 
the board, as it provides a method of exiting the normal operating code and entering either the 
bootloader or the BUFFALO debug monitor, depending on the setting of the memory map 
jumpers (see “2.1.7 - JP1 - Memory map jumpers” and “5.1 - Memory Map”). 
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NOTE: If you have configured the PC Weasel to "Reset PC on boot" (see “3.2.5 - Reset PC on 
boot”), executing this command will cause the PC Weasel to reset the PC. 


22 


; 
pies ost ane 


Quit to ROM 
Send Key To PC 
Get KBD Status 


Function Keys 


Figure 16: Summary of PC Weasel Commands 
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3.2 PC Weasel Configuration 


The PC Weasel maintains user-customizable configuration information in (nonvolatile) 
EEPROM. As described in "3.1.6 - Configuration - c", this command invokes the configuration 
menu, allowing the user to change selected parameters. The configuration menu is exited by 
pressing the <esc> key, at which time any changes made are committed. 


System Configuration (C) Copyright 1985-1991, American Megatrends Inc., 


Main Processor : 80386 Base Memory Size 
Numeric Processor : Present 
Floppy Drive A: : 1.44 MB. 3=" PC Weasel Configuration 
Floppy Drive B: : 2.2 MB. 5S<“ 
Display Type : Monochrome Version: ; 
ROM-BIOS Date : 07/07/91 Weasel Attn char: 
Reset PC on boot: 


Baud rate: Ege) 

Parity: [a i 

Bits: 9 

H/W Flow control: 
Serial-Pass- Shr Oe 
Allow Watchdog: 

Pass <BREAK> to 16550: 
Boot Image: 

CPC Weasel V1.00 


64 KB CACHE MEMORY 
Starting MS-DOS... 


C2\2 


HIONMOOWD 


Enter Field to change: fj 


<ESC> to qui 


Figure 17: PC Weasel Configuration Screen 


3.2.1 Version - (Not user-modifiable) 


This is the PC Weasel firmware version. It is defined at compile time. 


3.2.2 Boot Image - (Not user-modifiable) 


This is the (maximum) 32-character description entered into the bootloader when the selected 
firmware image is programmed into a FLASH partition. See "4.3 - Loading a new FLASH image 
into the PC Weasel". 


3.2.3, Attention Character - (User-modifiable) [ Default: ‘le’ (<control><*> or <control><~>) ] 


As described in "3.1 - Commands", the PC Weasel normally works transparently, passing 
keystrokes and ie characters back and forth between the user and the host PC. In order to 
invoke the PC Weasel's supervisory features an “Attention Character” is designated, upon receipt 
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of which from the user the PC Weasel brings itself "online" and accepts further commands from 
the user. 


The default Attention Character is <control><“> or <control><~> (Ox1le), so chosen because we 
couldn't think of anything else that used it. The user may specify any hex value from "0x00" to 
"Oxff" (except <c> or <C> - see caveat below) as the Attention Character. Though it may not be 
immediately apparent, there are numerous pitfalls awaiting the unwary user who changes the 
Attention Character without giving the matter sufficient consideration. 


CAVEATS: 


Inevitably, the user will eventually find that the selected Attention Character is the same as some 
character required for the normal operation of an application running on the host PC. In this case, 
typing the Attention Character a second time will cause it to be sent through to the PC. If, 
however, a PC Weasel Command character (see 3.1 - Commands) has been chosen as the 
Attention Character, the ability to use that PC Weasel Command will be lost. 


It is the responsibility of the user to ensure that the desired Attention Character can in fact be 
generated by the chosen terminal program, and that the Attention Character will not be 
intercepted by any program (eg ssh) or device (eg async server) in the path between the user and 
the PC Weasel. The only prohibition is the use of <c> or <C> as the Attention Character, as 
allowing it would only serve to deprive the user of the ability to further access the Configuration 
menu. 


The value "0x00" (ASCII "NUL") has a special meaning: <break>. Should the user choose to use 
<break> as the PC Weasel's Attention Character, it is important to note that a <break> wi// not be 
sent to the PC regardless of the setting of the "3.2.4 - Pass <break> to the PC" configuration 
option. 


3.2.4 Pass <break> to the PC - (User-modifiable) [ Default: Yes ] 


The BSD family of UNIXen optionally interprets a console <break> as instruction to enter the 
kernel debugger. Depending on the user's application and preference, this can be either a 
"feature" or a "bug". 


The "Pass <break> to PC" configuration option permits the user to direct the PC Weasel to filter 
incoming breaks or pass them through to the PC. Please note that this setting will be effectively 
overridden should the user set <break> as the PC Weasel’s Attention Character (See: "3.2.3 - 
Weasel Attention Character"). 
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3.2.5 Reset PC on boot - (User-modifiable) [ Default: No ] 


As indicated in "3.1.9 - Quit to ROM - q", the PC Weasel's bootloader routines are contained in 
nonvolatile EPROM. It is these routines that are first to be executed when the PC Weasel is reset, 
either manually or upon power-up. 


After initialization, the bootloader counts down a five-second delay, at the conclusion of which 
(assuming the user does not intervene) the bootloader will identify and commence execution of 
the default software image. The "Reset PC on boot" configuration option allows the user to 
control the startup sequence of the PC Weasel and host PC. 


If this option is set to "YES", the bootloader will place - and hold - the PC in reset as soon as the 
PC Weasel comes out of reset. Once the PC Weasel is up, it releases the PC's reset and allows the 
host to boot. This ensures the user is able to monitor the entire PC boot sequence. It also allows 
the user arbitrary time to perform configuration operations on the PC Weasel while delaying the 

PC's boot. 


Selecting "YES" will also cause the bootloader to force the host PC into reset if the user uses the 
"gq - Quit to ROM" (see 3.1.9) command to exit the PC Weasel's operating software and enter the 
bootloader. 


Conversely, selecting "NO" will allow the PC to boot regardless of the operational state of the PC 
Weasel, and allow the user to exit to the bootloader without forcing the PC into reset, desirable in 
the event that the user wishes to load a new operating image into the PC Weasel's FLASH without 
bringing down a running host. 


It should be evident to the reader that in this case there is no "right"setting, there is only the right 
setting for a particular circumstance. 


3.2.6 Serial Pass-through - (User-modifiable) [ Default: No ] 


NOTE: This section is crucial to understanding the operation of the PC Weasel and its inherent 
limitations. Subsequent confusion may be avoided if the user takes a few minutes to 
reflect upon these fundamentals. 


The PC Weasel's two basic modes of operation are: 
Emulation mode, in which characters written into the MDA memory (frame buffer) by 
the host CPU are converted to serial data and transmitted to the user, and input received 


from the user is presented to the host CPU as though originating from a local keyboard, 


and 
Serial Pass-through mode, in which the host CPU communicates bidirectionally via 


the PC Weasel's onboard 16550, with each character passed back and forth between the 
host and the user by the PC Weasel’s CPU. 
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To the host PC, then, the PC Weasel represents two distinctly separate I/O devices: a 16550 
UART and an MDA video board. This means that although the board has two channels capable of 
simultaneously generating outbound data destined for the user, there is only one channel via 
which that output can be directed to the user - the RS-232 port. 


By default (that is, with Serial Pass-through mode disabled by setting it to "NO" in the 
Configuration menu) the PC Weasel operates in Emulation mode only. The MDA and keyboard 
emulations are in full-time operation, and although the 16550 UART, if enabled (see "2.1.9 - JP3 
- 16550 UART ISA Address" and "2.1.10 - 16550 UART ISA Interrupt"), is available to the host 
PC's ISA bus, its serial I’O is disconnected from the outside world. 


If Serial Pass-through mode is enabled (ie set to "YES" in the Configuration menu) the PC 
Weasel will monitor the 16550 UART for activity, and upon detecting a character output from the 
16550 UART will exit Emulation mode and begin relaying characters between the 16550 UART 
and the RS-232 connector. 


Conversely, if the PC Weasel is operating in Serial Pass-through mode and detects data written to 
the MDA buffer, it will disconnect the 16550 UART's serial I/O and switch back to Emulation 


mode. 


In either mode the PC Weasel continues to monitor the data stream input by the user and will 
bring itself online upon detection of the Attention Character. 


This is an arrangement that allows for the greatest possible flexibility and user choice in 
determining how the host's console appears to its operating system, while ensuring that a 
functional console will always be available on a machine that has crashed down to the BIOS. 


Although the PC Weasel has been designed to manage the direction of traffic in an intelligent 
and appropriate manner, it is possible to make the board do bad things. 


Specifically, if Serial Pass-through mode is enabled and the host PC outputs data to the 16550 
UART and MDA buffer simultaneously, the PC Weasel will flap, losing characters and/or 
outputting interleaved characters from the two sources. 


3.2.7 Baud rate - (User-modifiable) [| Default: 9600 ] 


The PC Weasel DUART supports serial data rates from 300 baud to 230.4 kbaud. The default 
speed as delivered from the factory is 9600 baud. Should the nonvolatile EEPROM used for stor- 
ing this and other configuration parameters become corrupt (due to CPU replacement, manual 
manipulation of entries, etc.) the PC Weasel will revert to 9600 baud. 


Obviously, should this happen, communication with the user's async server, terminal, etc. will 


cease until the user reconfigures that device to match the PC Weasel's data rate, at which time the 
PC Weasel's previously-programmed speed configuration can be restored. 
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While it may be tempting to avoid this possibility by simply using 9600 baud for normal PC 
Weasel operation, such would be less than desirable. Higher data rates (particularly 38.4 kbaud 
and above) will greatly enhance viewing pleasure in Emulation mode. 


The user should also be aware of the implications of the UART baud rate setting with respect to 
Serial Pass-through mode. As explained in section 3.2.6, the use of the onboard 16550 UART in 
Serial Pass-through mode involves the PC Weasel's DUART relaying data between the user and 
the 16550 UART. This being the case, it is obviously necessary for the 16550 UART and the PC 
Weasel's DUART to be operating at the same baud rate. Ensuring this congruity is the 
responsibility of the user. 


NOTE: Hardware support has been provided to allow the PC Weasel's DUART baud rate to 
automatically track that of the 16550 UART. This is done by programming the DUART 
to use an externally-generated clock instead of its internal baud rate generator, and 
supplying that external clock from the 16550 UART's baud rate clock output. At 
present, no software support is provided for this option, as it is a whole shelf of cans of 
worms. 


3.2.8 Hardware (H/W) Flow control - (User-modifiable) [ Default: No ] 
This option permits the selection of RS-232 hardware (RTS/CTS) flow control. 


As the PC Weasel is primarily intended as a console device, and as such will generally not be 
handling high traffic volumes, we recommend leaving this set to the default "NO". 


Should the user wish to use flow control, it is recommended that special attention be paid to cable 
selection or construction. We have seen a remarkable variety of cables all claiming to be "Null 
Modem", many of which are incomplete and/or incorrect. If a PC-to-PC null modem cable is 
required, we suggest the pinning illustrated in Figure 18. 
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Figure 18: Null modem cable (DB-9) 


3.2.9 Bits - (User-modifiable) [ Default: 8 ] 


This setting determines the number of data bits per character used by the PC Weasel's DUART. 
Options are "7" and "8". 


3.2.10 Parity - (User-modifiable) [ Default: None ] 


This setting determines the parity configuration of the PC Weasel's DUART. Options are 
"NONE", "EVEN", and "ODD". 


3.2.11 Allow Watchdog - (User-modifiable) [ Default: No ] 


This configuration option causes the PC Weasel to monitor for an "arm watchdog” sequence from 
the host PC. This option is provided to prevent accidentally enabling the watchdog. Further 
details can be found in “6.3 - Watchdog timer’. 
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4. PC Weasel Programmer’s Guide 
4.0 Introduction 


This section describes the preferred development environment for writing, testing, debugging, 
and burning code for the PC Weasel. The board employs two microcontrollers - the Motorola 
68HC11 (2 MHz A1 version) and the Atmel AT90S4433 (AVR) - requiring tools for both parts. 


4.1 Required pieces 


This suite has been constructed to provide the required functionality: a) under Unix, and b) for 
free. The developer is by all means entitled to prefer other tools. 


4.1.1 Compiler and assembler 
The PC Weasel toolchain consists of the following: 
a) Gnu "C" - gec-2.6.3 
b) Canada Connect's gcc-6811 patches for gcc-2.6.3! 
Notes: Although an attempt was made to use a set of 68HC11 patches for gcc-2.8.1 , these 
were found to have introduced more problems than they solved. A bug was 


discovered which caused interrupt handlers (employing "#pragma interrupt") to 
clobber the ZDO pseudo-register if any functions were called from within an 


interrupt context. Our patch addresses this problem’. Jfyou obtain the gcc-681 1 
patches to gcc-2.6.3 elsewhere, you may not be able to generate functional code. 


We have recently become aware of an egcs-based toolchain for the 68HC11. As of 
this writing, we have not experimented with this toolchain. 


c) TAVRASM - AVR Assembler for keyboard controller 


d) Canada Connect's patches for TAVRASM! 
System requirements: 
a) Unix. Our tested and preferred flavours are NetBSD/i386 and NetBSD/sparc. 


b) make. In our case, "bmake" or "Berkeley Make", included with "NetBSD", "FreeBSD", 
and "OpenBSD". 


1. You can obtain these patches directly from our ftp server: ftp://ftp.realweasel.com/pub/realweasel/ 
2. With thanks to J.T. Conklin and Dean Huxley 
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4.1.2 gccll compiler installation procedure 


. Download our patched gccl1 patches. 

. Download gec-2.6.3 from an FSF supported site or our ftp. 
. Download TAVRASM. 

. Download TAVRASM-patch. 

. Create an expendable temporary working directory. 

. Untar the patches for gcc-2.6.3 . 

. Untar gcc-2.6.3 proper. 


NNN BWN 


You should now have the following in your working directory: 


dmx xx 7 wot wheel 8704 dm 11 1618 gx-263 
-w-r-xr- 1 wot wheel6521230 Sep 1 08:9 gcee-263 targz 
-w-%r-2r- 1 wot wheel 240160 Sep 1 0756 gec- 6811 targz 
diver xx 5 wot wheel 512 Mar 4 1995 goc-6811 


8. cd into the gcc-6811 directory, read the "README" file, and follow the instructions for the 
installation of the compiler. (Look for the heading "INSTALLATION PROCEDURES 
FOR UNIX SYSTEMS") 


# od gcc- 6811 
# more README 


Note that on the '/configure' line, "--host=next" will need to be modified as appropriate for 
your system. In the case of NetBSD/i386, this entry should read: 


~ - host= B86 - unknown- netbadl 31 

Upon completing the given installation procedure, the final step is to 
chown < instal /Ib/goc- Ib/m6811- beaV2 63 <yow 

as the makefile will put the PC Weasel "crt0.s" files into this directory. 


This concludes the gcc installation procedure. Assuming that the relevant binaries are in your 
SPAIH variable, you should now be able to type "make" in the PC Weasel source code directory 
and generate a set of S-Records (.s19) suitable for programming into the PC Weasel. 


4.2 Sample Make Session 


/usr/local/bin/gecll -02 -Wall -Wstrict-prototypes -Wmissing-prototypes -I.. -c 
bcopy.c 7 

/usr/local/bin/gccll -02 -Wall -Wstrict-prototypes -Wmissing-prototypes -I.. -c 
strcomp.c 

/usr/local/bin/gecll -02 -Wall -Wstrict-prototypes -Wmissing-prototypes -I.. -c bemp.c 
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/usr/local/bin/gccll -O02 -Wall -Wstrict-prototypes 


bzero.c 

/usr/local/bin/gccll -02 -Wall -Wstrict-prototypes 
/usr/local/bin/gcecll -02 -Wall -Wstrict-prototypes 
printst.ec 

/usxr/local/bin/gccll -O2 -Wall -Wstrict-prototypes 
strcat.c 

/usr/local/bin/gecll -02 -Wall -Wstrict-prototypes 
strlen.c 

/usr/local/bin/gcecll -O02 -Wall -Wstrict-prototypes 
/usr/local/bin/gecll -c divhi3.s 
/usx/local/bin/gccll -c modhi3.s 


{objlist built] 

/usr/local/bin/gecll -O1 -Wall -Wstrict-prototypes 
DWEASEL_VERSION="\"v1.00\"" -¢ sci.c 
/usxr/local/bin/gccll -O1 -Wall -Wstrict-prototypes 
DWEASEL VERSION="\"v1.00\"" -c weasel.c 
/usxr/local/bin/gcecll -O1 -Wall -Wstrict-prototypes 
DWEASEL VERSION="\"v1.00\""  -c delay.c 
/usr/local/bin/gccll -O1 -Wall -Wstrict-prototypes 
DWEASEL VERSION="\"v1.00\"" -c rbuf.c 
/usxr/local/bin/gecll -O1 -Wall -Wstrict-prototypes 
DWEASEL_VERSION="\"v1.00\"" 
/usxr/local/bin/gcecll -0O1 -Wall -Wstrict-prototypes 
DWEASEL VERSION="\"v1.00\"" =¢ spi.c 
/usr/local/bin/gcecll -O1l -Wall -Wstrict-prototypes 
DWEASEL VERSION="\"v1.00\"" -c avr_util.c 
/usr/local/bin/gecl1ll -O1 -Wall -Wstrict-prototypes 
DWEASEL_VERSION="\"v1.00\""  -c s19.c 
/usr/local/bin/gcecll -O1l -Wall -Wstrict-prototypes 
DWEASEL VERSION="\"v1.00\"" =c¢ kbd.c 
/usr/local/bin/gccll -Ol1 -Wall -Wstrict-prototypes 
DWEASEL VERSION="\"v1.00\""  -c cfg.c 
/usr/local/bin/gecll -O1 -Wall -Wstrict-prototypes 
DWEASEL VERSION="\"v1.00\"" -c wdt.c 
/usxr/local/bin/gcecll -O1 -Wall -Wstrict-prototypes 
DWEASEL_VERSION="\"v1.00\"" 
/usr/local/bin/gecll -O1l -Wall -Wstrict-prototypes 
DWEASEL VERSION="\"v1.00\"" 
/usr/local/bin/gecll -O1 -Wall -Wstrict-prototypes 
DWEASEL VERSION="\"v1.00\""  -c msgbuf.c 
/usr/local/bin/gcecll -O1 -Wall -Wstrict-prototypes 
DWEASEL VERSION="\"v1.00\""  -c scn_weasel.c 
/usxr/local/bin/aslink -o flash -s -m -bLABEL=0x100 
bMDA_MIRROR=0x8 000 -bSTACK=0xB000 -bMDA_BUF=0xC000 


-c screen.c 


-c eé€.c 


-c regem.c 


“Gat Lab/ebylaise” = 
/usr/local/bin/aslink -o ram -s -m 


-bSTARTUP=0x100 -b_CODE=0x130 


-Wmissing-prototypes 


-Wmissing-prototypes 
-Wmissing-prototypes 


-Wmissing-prototypes 
-Wmissing-prototypes 


-Wmissing-prototypes 


-Wmissing-prototypes 
-Wmissing-prototypes 
-Wmissing-prototypes 
-Wmissing-prototypes 
-Wmissing-prototypes 
-Wmissing-prototypes 
-Wmissing-prototypes 
-Wmissing-prototypes 
-Wmissing-prototypes 
-Wmissing-prototypes 
-Wmissing-prototypes 
-Wmissing-prototypes 
-Wmissing-prototypes 
-Wmissing-prototypes 


-Wmissing-prototypes 
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-c atoh.c 


a ae 


-DMAXFLASH - 


-DMAXFLASH - 


-DMAXFLASH - 


-DMAXFLASH - 


-DMAXFLASH - 


-DMAXFLASH - 


-DMAXFLASH - 


-DMAXFLASH - 


-DMAXFLASH - 


-DMAXFLASH - 


-DMAXFLASH - 


-DMAXFLASH - 


-DMAXFLASH - 


-DMAXFLASH - 


-DMAXFLASH - 


-bSTARTUP=0x130 -b_CODE=0x200 - 

-b_ BSS=0x9000 -b_DATA=0x7800 /usr/ 
local/gnu6811/lib/gcc-lib/m6811-local/2.6.3/weasel_crt0.o sci.o weasel.o delay.o rbuf.o 
screen.o spi.o avr_util.o s19.0 kbd.o cfg.o wdt.o ee.o regem.o msgbuf.o scn_weasel.o 


-bSTACK=0x6000 - 


bMDA_MIRROR=0x7000 -bLABEL=0x8000 -bMDA_BUF=0xC000 /usr/local/gnu6811/lib/gcc-lib/ 
m6811-local/2.6.3/weasel_ crt0.0o sci.o weasel.o delay.o rbuf.o screen.o spi.o avr_util.o 
s19.0 kbd.o cfg.o wdt.o ee.o regem.o msgbuf.o scn_weasel.o ‘cat lib/objlist*™ ; 


/usr/local/bin/tavrasm -m -v kbd.asm -o kbd.rom 
Toms AVR macro assembler version 1.07 (Jul 21 1999) 


Copyright (C) 1999 - Tom Mortensen 


E-mail: tomo@image.dk WWW: http://www.image.dk/~tomo 
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Code £ 2357 
Rom : 0 
Data 3 QO 
Unused Code : 0 
Unused Rom : 0 


/usr/local/bin/gecll -01 -Wall -Wstrict-prototypes -Wmissing-prototypes -DMAXFLASH 
DWEASEL VERSION="\"v1.00\""  -c bootmain.c 

/usr/local/bin/gccll -01 -Wall -Wstrict-prototypes -Wmissing-prototypes -DMAXFLASH 
DWEASEL VERSION="\"v1.00\"" -c flash.c 

/usr/local/bin/gccll -01 -Wall -Wstrict-prototypes -Wmissing-prototypes -DMAXFLASH 
DWEASEL VERSION="\"v1.00\""  -c avr.c 

/usr/local/bin/gcecll -01 -Wall -Wstrict-prototypes -Wmissing-prototypes -DMAXFLASH 
DWEASEL VERSION="\"v1.00\""  -c scn_bootrom.c 

/usr/local/bin/aslink -o boot_ram -s -m -bSTACK=0xB000 -bSTARTUP=0x8000 -b_ CODE=0x8300 
/usr/local/gnu6811/lib/gcec-lib/m6é811-local/2.6.3/bootloader crt0.o bootmain.o delay.o 
rbuf.o s19.0 flash.o avr.o avr_util.o spi.o ee.o scn_bootrom.o ‘cat lib/bl_objlist’° 
/usr/local/bin/aslink -o boot_rom -s -m -bSTACK=0xB000 -bSTARTUP=0xE040 -b_CODE=0xE054 
-b_BSS=0x9000 -bVECTORS=0xffd6é /usr/local/gnu6811/lib/gcc-lib/m6811-local/2.6.3/ 
bootloader crt0.o bootmain.o delay.o rbuf.o s19.0 flash.o avr.o avr_util.o spi.o ee.o 
scn_bootrom.o ‘cat lib/bl_objlist° 

sort -o boot_rom_sort.s19 +0.1 -0.2 +0.4 boot_rom.s19 


_CODE E054 1EEF = 7919. bytes (REL, CON) 
VECTORS FFDE 002A = 42. bytes (ABS, OVR) 
STARTUP E040 0011 = 17. bytes (ABS,OVR) 
_DATA FF43 0066 = 102. bytes (REL, CON) 


Overhead: 93 
Total Boot ROM Size= 8173 


/usr/local/bin/gecll -01 -Wall -Wstrict-prototypes -Wmissing-prototypes -DMAXFLASH - 
DWEASEL VERSION="\"v1.00\""  -c diagmain.c 

/usr/local/bin/aslink -o diag_ram -s -m -bSTACK=0x6000 -bSTARTUP=0x100 -b_CODE=0x130 / 
usr/local/gnu6811/lib/gcec-lib/mé811-local/2.6.3/diag_crt0.o diagmain.o delay.o rbuf.o 
sci.o ee.o flash.o ‘cat lib/diag_objlist’ 

/usr/local/bin/aslink -o diag_rom -s -m -bSTACK=0xB000 -bSTARTUP=0xE040 -b_ CODE=0xE054 
-b_BSS=0x9000 -bVECTORS=Oxffd6 /usr/local/gnué811/lib/gcc-lib/m6811-local/2.€.3/ 
diag_crt0.o diagmain.o delay.o rbuf.o sci.o ee.o flash.o ‘cat lib/diag_objlist’ 

sort -o diag rom_sort.s19 +0.1 -0.2 +0.4 diag_rom.s19 

/usr/local/bin/aslink -o demo -s -m -bLABEL=0x100 -bSTARTUP=0x130 -b_ CODE=0x200 - 
bMDA_MIRROR=0x8000 -bSTACK=0xB000 -bMDA_BUF=0xC000 -b_BSS=0x9000 ~b_DATA=0x7800 /usr/ 
local/gnu6811/lib/gcc-lib/m6811-local/2.6.3/weasel_crt0.o sci.o weasel.o delay.o rbuf.o 
screen.o spi.o avr_util.o s19.0 kbd.o cfg.o wdt.o ee demo.o regem.o msgbuf.o 
scn_weasel.o ‘cat lib/objlist*® ; 

/usr/local/bin/aslink -o demo_rom -s -m -bSTACK=0xB000 -bSTARTUP=0xE040 -b CODE=0xE054 
-b_BSS=0x9000 -bVECTORS=0xffd6 /usr/local/gnu6811/lib/gcc-lib/m6811-local/2.6.3/ 
bootloader crt0.o0 demobootmain.o delay.o rbuf.o sl19.0 flash.o avr.o spi.o 


scn_bootrom.o ee.o avr_util.o ‘cat lib/bl_objlist” 

sort -o demo_rom_sort.sl19 +0.1 -0.2 +0.4 demo_rom.s1$ 

_CODE E054 1D58 = 7512. bytes (REL, CON) 
VECTORS FFD6 002A = 42. bytes (ABS,OVR) 
STARTUP E040 0011 = 17. bytes (ABS,OVR) 
_DATA FDAC 0068 = 104. bytes (REL,CON) 


Overhead: 93 
Total Boot ROM Size= 7768 
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4.3 Loading a new FLASH image into the PC Weasel 


The PC Weasel's operating code store consists of a 1 megabit (128kbyte) FLASH memory 
organized as four partitions of 32kbytes each. The PC Weasel can thus be loaded with up to four 
distinct operating images, any one of which can be marked as the default boot image. This gives 
the user the ability to test new images while maintaining known-good images in FLASH as 
backup. 


As described in section 3.0, the PC Weasel’s FLASH programming routines reside in the 
EPROM. The user can enter these routines by entering <esc> during the bootstrap countdown as 
shown in figure 19. 


Weasel Bootloader version: $Revision: 1.45 $ 


D PC Weasel V1.00 


1 
2 
3 
4 


Booting: (C1 - PC Weasel V1.00] 
eeeSESey 80 AOOPGs« ca sx sa Bes ances Boot Aborted... 
- Load image 
Program Keyboard Flash 


1 

k= 

d - Change Default partition 
1 - PC Weasel V1.00 
re 
3 - 
4- 


Enter Option C1]: J 


Figure 19: PC Weasel programming menu 
Upon entering the programming menu, this sequence should be followed: 
1. Type <I> 


2. Provide an image name. A maximum of 32 characters is allowed. 


Uo 


. Enter the partition number (1-4). 

This is the place not to make a mistake, as the selected partition will immediately be erased. 
4. Transmit the binary 
The PC Weasel loader uses a common ASCII format for the exchange of binary data known 


as the "S Record". Details of this format may be found in Appendix 1. Each record in the file 
consists of a line of ASCII text containing header, data, and checksum information. 
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As each record requires a short period of time for processing and programming into FLASH, 
the PC Weasel bootloader outputs a prompt/pacing character (">") indicating that the previous 
record programmed successfully and the next may be transmitted. The user must configure 
the communications program being used to conform to this behaviour. The following exam- 
ple illustrates the configuration of Kermit for this purpose: 


C-kemib set xm it pause 0 
C-kemibD set xn it pmmpt 62 


The only problem likely to occur while programming the PC Weasel's FLASH is a failure of 
communications while transmitting the S Records. The PC Weasel's loader calculates and 
verifies the checksum for each line of information, and will abort the load process if an invalid 
checksum is detected. The user will then be returned to the boot menu. 


The two most probable causes for such a failure are: 


- Too high a data rate. Though the PC Weasel has been tested to 115.2kbaud, any weirdness is 
a reasonable justification for slowing down a little. 


- Not correctly waiting for the ">" prompt. 


5. Specify the default boot image 


After all of the records have been sent and accepted, the PC Weasel will prompt the user as to 
whether the image just loaded is to be marked as the default boot image. Entering <y> or <n> 
accordingly will cause that information to be stored, and the bootloader to immediately begin 
executing the default image, if one is so marked. 


4.4 Loading a new keyboard controller image to the PC Weasel 


To load a new keyboard controller image, the user should perform the following steps at the prog- 
amming menu: 


1. Type <k>. 


2. Confirm that the existing keyboard image should be overwritten by pressing <y>. Typing <n> 


at this point, will abort the programming process and return the user to the programming menu. 


3. Transmit the binary. 
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As with the FLASH image, the data format used to transfer the binary keyboard image is the 
ASCI based S-Record (see Appendix 1). 
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Once the data transfer has completed, the PC Weasel will return to the programming menu, where 


the user may continue with the programming process, or choose to boot one of the valid boot 
images. 
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5. PC Weasel API 


5.0 Introduction 


This section describes the internal organization and programmer's model of the PC Weasel. It is 
intended for those developing software for the board, and will be of only passing interest to those 
wishing simply to use the board and not develop software on or for it. 


PC Reset 


scl 


PC Keyboard 68HC11 


Debug Port 


ISA 


DB9P 
Connector 


Figure 20: PC Weasel internal block diagram 


It is assumed that the user is able to obtain the manufacturers’ data sheets for the chips used on the 
PC Weasel board, as they are too extensive to reprint here. A list of references is provided in 
Appendix 3. 


5.1 Memory Map 
Unless otherwise noted, "RAM" is volatile CMOS static memory. 


Unlike low-cost memory commonly used in video applications, the dual-port RAM used for the 
MDA buffer and register emulation is true dual-port memory. This allows for contention-free 
simultaneous read/read access and write/read (write-through) by the ISA and 68HC11 buses. As 
the 68HC11 does not normally (but can) write into the MDA buffer, write-write contention should 
not be an issue. 
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The PC Weasel's memory map is shown in Figure 21. All I/O is, in the finest Motorola tradition, 


memory mapped. 


Address Range 


Device 


Comments 


Oxffff 


Oxe040 


Monitor/bootloader * 


32Kx8 EPROM ICS is divided into four 8K blocks. The 
block that is mapped into the space E040-FFFF is 
selected by jumpers JP1. 


— 


Oxe03f 


Oxe000 
ite 


Oxd fff 


0xd000 


Oxcfiff 


0xc000 


Oxbfif 
0xb800 


OxbS5 ff 
Oxb4 ff 
0xb400 


Oxb3 ff 
0xb300 


68HC11 onchip L’'O 


Dual-port RAM 
ASA register emulation a 
semophores) 


Monitor‘bootloader relocates I/O to E000 via CONFIG 
register within first 64 cycles of machine operation. 


nd 


Dual-port RAM 
(MDA buffer) 


Reserved 


Memory Map Register 


0xb500 (ro) 


Flash Register (r/w) 


Modem Register (rw) 


a ee 


Oxb7ff 68HC11 onchip EEPROM 
0xb600 


ee a ee ee 


Oxb2ff 
0xb200 


Oxb1 ff 
0xb100 


OxbOff 
Oxb000 


DUART 


Interupt Registers 
Video Register 


(AVR, POST, CRTC, UART) 


Reserved 


nee ee ie aaa ee eer ees 


Oxafff 


0x8000 
Ox7 fff 


0x0100 


Ox00ff 
0x0000 


cbs 


FLASH or RAM * 


The 128K x8 FLASH IC4 is divided into four 32K 
blocks. Which of these is mapped into the memory 
space is selected via the FLASH register. Where in the 


RAM of FLASH * 


memory space the selected block is mapped is a function 
of jumper JP] 


68HC11 onchip RAM 


* Memory map dependent 
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Figure 21: PC Weasel Memory Map 
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5.1.1 Memory Map Jumpers 


The "memory map dependent" areas indicated in Figure 21 are functions of the setting of the 
Memory Map jumpers, shown in Figure 4. 


The presence of a jumper = 1; absence = 0. The board will normally run without jumpers, thus 
selecting map 0. 


Map | 0x0000-0x7fff 0x8000-OxAfff 0xe040-Oxffff oo 
0 FLASH RAM EPROM block 3 Bootloader 
1 FLASH RAM EPROM block 2 BUFFALO 
Z = EPROM block 1 Reserved 
3 EPROM block 0 BUFFALO 


Table 1: Memory Map Settings 


5.1.2 Memory Map Register 


The setting of the two Memory Map jumpers can be read via the Memory Map Register as 
follows: 


7 6 5 4 3 2 1 0) 
0xb500 0 0 0 0 0 0 MAPI | MAPO 
t/O r/o r/o r/o r/o r/o r/o r/o 
RESET 0 0 0 0 0 0 x x 


legend: r/o = read only 
X= not changed 


Figure 22: Memory Map Register 


§.1.3 Flash Register 


The PC Weasel's nonvolatile code store consists of a 128Kx8 flash memory broken into four 
32Kx8 blocks. Each block consists of two 16Kx8 sectors. 
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The Flash Register determines which of the four blocks is mapped into the memory space. Where 
it is mapped is a function of the "Memory Map" jumpers. 


This register into the 68HC11’s address space appears in the memory space at 0xb400. 


0xb400 


legend: r/o = read only 
r/w = read/wnite 


Figure 23: Flash Register 


Only the two least significant bits of this location have been implemented. The six upper bits 
should be masked off when the register is read. The Flashreg is not cleared by reset. 


5.2 Special purpose registers 


5.2.1 Video Register 


The video update register reduces the 68HC11's overhead by detecting writes by the ISA to the 
MDA memory space. It is organized as the first four bytes of an eight-byte block repeated 32 
times through the 0xb100-Oxb1ff address range. 


Each bit corresponds to one line of characters on the video display. Any ISA write to the video 


memory sets the bit in the Vidreg corrsponding to that line. Reading a byte clears that byte. Bits 
indicated by "--" read "0". 
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0xb100 
Oxb101 
Oxb102 
Oxb 103 


* This register is not affected by reset. 


Figure 24: Video Registers 


OxbOfa0-OxbOfff are accessible memory, but not displayed 


Each line of characters consists of two alternating components - a byte of character data followed 
by a byte of attribute data, with a total of 80 bytes of each. 


Lne 1: 
Lne 2: 
Lne 3: 
Le 4: 
Lne 5: 
Lne 6: 
Lre 7: 
Lne 8: 
Line 9: 


Lne 19: 
Lne 20: 
Lne 21: 
Lune 22: 
Lne 23: 
Lne 24: 
Lyne 25: 


Figure 25: Video Register Mapping 
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Oxb0000 - 
Oxb00a0 - 
Oxb0140 - 
OxbO01e0 - 
Oxb0280 - 
Oxb0320 - 
Oxb03c0 - 
Oxb0460 - 
Oxb0500 - 
Oxb05a0 - 
Oxb0640 - 
Oxb06e0 - 
Oxb0780 - 
Oxb0820 - 
Oxb08c0 - 
Oxb0960 - 
Oxb0a00 - 
Oxb0aad - 
Oxb0b40 - 
OxbObed - 
Oxb0c80 - 
Oxb0d20 - 
OxbOdcO - 
Oxb0e60 - 


Oxb0fD0 - 


Oxb009F 
Oxb013£ 
Oxb01d£ 
Oxb027£ 
Oxb031£ 
Oxb03bE 
Oxb045£ 
Oxb04 fF 
Oxb059£ 
Oxb063£ 
Oxb06dE 
Oxb077£ 
Oxb081£ 
Oxb08bE 
Oxb095£ 
Oxb09 fF 
Oxb0a9£ 
Oxb0b3£ 
Oxb0bd£ 
Oxb0c7£ 
OxbOd1£ 
OxbO0db£ 
Oxb0e5£ 
Oxb0eft 
Oxb0PE 
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5.2.3 POST & CRTC Interrupt 


This register is part of the Vidreg, and appears in the memory space at 0xB104. 


i 6 5 4 3 2 1 0 
0xB104 0 0 0 0 0 CRTC | POST | ENABLE 
r/o r/o r/o r/o r/o r/c r/c t/w 
RESET 0 0) 0 0 0 xX xX 0 


legend:r/o = read only 
r/c =read/clear 
t/w = read/write 
X = not changed 


Figure 26: POST and CRTC Interrput 
An ISA write to port 0x80 (the Power On Self Test) register address will set bit 1. An ISA write 
to any port in the address range 0x3b0-3bb will set bit 2. If the enable bit (bit 0) is set, the setting 


of either the POST or CRTC bit will result in an XIRQ to the 68HC11. A read of this register will 
clear both bits. 


5.2.4 AVR Interrupt Register 

An active level on the AVR's interrupt output will set the AVRINT bit in this register. The bit 
will be cleared upon read of the register by the HC11. If the ENABLE bit is set, an XIRQ will 
also be generated when the AVRINT bit is set. 


This register appears in the memory space at 0xb105S. 


7 6 5 4 3 2 1 0 
oxb10s | 0 0 0 0 0 0 | AVRINT | ENABLE | 
| t/o r/o r/o r/o r/o t/o r/c t/w | 

RESET 0 0 0) 0) 0 0 x 0 


legend:r/o = read only 
t/c = read/clear 
t/w = read/write 


Figure 27: AVR Interrupt Register 
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5.2.5 UART Interrupt Register 
This register appears in the memory space at 0xb106. 


It is used to generate a 68HC11 XIRQ in the event of an ISA write to the onboard 16550 UART, 
providing the UART is enabled (see 2.1.9 “JP3-16550 UART ISA address”). Upon a write, the 
bit corresponding to the UART's address will be set. Reading the register clears the bit. If the 
ENABLE bit is set, a processor interrupt will also be asserted when the bit is set. Once a write has 
been detected, the data written to the register (providing that data has not been overwritten by a 
subsequent ISA write cycle) will be available in the appropriate shadow register location in the 
dual-port RAM. 


7 6 5 4 3 

0 0) 0 UART4 | UART3 | U 
t/o r/o r/o r/c r/c 

0 0 0 > xX 


legend: r/o= read only 
t/c= read/clear 
t/w= read/write 


Oxb 106 


RESET 


Figure 28: UART Interrupt Register 


5.2.6 Modem Register 


The Modem Register is a control element connecting the modem control lines of the 16550 
UART, the 26C92 DUART, and the back-panel DB-9P RS-232 connector. Each of the six signals 
can be individually permitted to pass through, tied high or low, or (in the case of RTS and CTS) 
switched to one of two sources. 


The status of the six modem control signals can be monitored by the CPU. The following table 


shows where each of the signals appears in the HC11's I/O space, as well as the source of the 
signal. 
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Signal Source/Level Destination | Read at 
dl do dl do dl do dl do 
0xb300 16550 HCl11 
PA2 
0xb301 16550 DUART 
IP 1/ 
CTSB 
Oxb302 16550 HC11 
PAO 
0xb303 16550 DUART 
IP2 
0xb304 DTR | 16550 l 16550 DB-9 HCll 
PAI 
Oxb305 RTS | 16550 ] DUART DB-9 DUART 
RTSB CTSA 


* Reset state 


Notes: "0" and "1" refer to /ogic levels. In RS232-speak, "0" is asserted and "1" is non-asserted. 
At present this register is write-only. Readback may be added in later versions. 


Table 2: Modem Register 
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68HC11 


PA2 
PA1 
PAO 


RI 


RI 

DCD DCD 

DSR Bete 
DB-9 16550 
Connector UART 

ENS Z DTR 

CTS CTS 

Oxb302 1 
RTS RTS 


RTSB 
RTSA 


DUART CTSA 


CTSB 
IP2 


* Reset State 


Figure 29: Modem Register 
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The 68HC11's on-chip I/O port A is used as follows: 


Pin Signal oa Notes 
PAO | RS-232 RI low I 
input 
monitor 
PA1 RS-232 low I 
DTR input 
monitor 
| eee ae! eee 
PA2 RS-232 low I 
DCD input 
monitor 
PA3 AVR SS low O 
input 
PA4 N/C 
PAS AVR reset low O 
When held in reset the AVR tristates its I/O pins. 
Since one of these I/O pins is the output driving the 
input of the AVR Interrupt Controller (see ...), the 
Interrupt Controller's input is left floating during 
AVR reset. If the AVR interrupt and XIRQ are 
enabled, spurious interrupts will result. The AVR 
interrupt should therefore not be enabled unless the 
AVR 1s out of reset and running. The 68HC11 
comes out of reset with this bit set to 0, holding the 
AVR in the reset state. 
ae a 
PA6 PC reset high O The 68HC11 comes out of reset with this bit set to 0, 
so the PC Weasel can reset and not reboot the host 
Bi. 
PA7 16550 N/A I 
UART baud 
rate clock 
out 
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Figure 30: 68HC11 Port A 
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5.2.8 DUART Clock 


The 26C92 DUART can be clocked from one or both of two sources. One is a standard 
3.6854MHz oscillator, permitting the use of the part's published baud rate tables. The other clock 
source is the baud rate clock output from the 16550 UART. This allows the DUART to be slaved 
from (and track) the UART's clock on one or both ports. This clock is supplied to the DUART's 
TxCA, RxCA, TxCB, and RxCB inputs. 


§.3 ISA Interface and Register Emulation 


The PC Weasel is designed to present the ISA bus with a functional emulation of the original IBM 
Monochrome Display Adapter (MDA). To the ISA, this appears as: 


1. 4K bytes of dual-port video RAM occupying 0xb0000-0xbOfff. This memory is not 
fully decoded, and thus also appears at Oxb1000-0xb 1 fff, 0xb2000-Oxb2fff,... and 
Oxb7000-Oxb7fff, for a total of eight images. 


68HC11 ISA | 
ADDRESS | ADDRESS | 
Oxbffff | 
CGA | 
Oxb8000 | 
Oxcfif Oxb7 fff | 
MDA | VGA/EGA 
0xc000 0xb0000 
Oxafftf 
0xa0000 


Figure 31: Video Memory 
2. I/O registers occupying (port addresses) 0x3b0-0x3bf as follows: 


0x3b0-0x3b3 not used 


Ox3b4 6845 CRTC address register 
Ox3b5 6845 CRTC data register 
0x3b6-0x3b7 not used 

Ox3b8 MDA video control register 
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0x3b9 not used 

Ox3ba MDA video status register 
Ox3bb not used 

Ox3be parallel (printer) data register 
Ox3bd parallel (printer) status register 
Ox3be parallel (printer) control register 
Ox3bf not used 


Of these registers, only the 6845 is emulated in the PC Weasel. The video control/status 
registers are not necessary (as no video is actually being generated) and the MDA 
parallel printer port is outside of the scope of the PC Weasel. 


The PC Weasel also (optionally) provides the ISA with a standard "COM-port style" 16C550 
UART for the user's console. It is address and interrupt configurable in the normal manner. 


5.3.1 6845 CRTC registers 


The 6845 CRT controller occupies two bytes in the ISA I/O space, but contains 18 data registers, 
each accessable first writing the register's address into the "CRTC address register", then reading/ 
writing the data to/from the selected register via the "CRTC data register". The 6845's registers 
are as follows: 


0x00-0x0d video timing control (write-only) 
Ox0e cursor address MSB (read/write) 
Ox0f cursor address LSB (read/write) 
0x10-0x11 light pen location (read-only) 


Of these, only the cursor address registers are relevant. The PC Weasel's address decoders 
demultiplex ISA read/write operations to these two addresses, making the registers available to 
the 68HC11 at locations 0xd7b4 (MSB) and 0xd7b5 (LSB). 


5.3.2, UART register shadowing 


If the user chooses to enable the PC Weasel's 16C550 UART, write operations from the ISA to 
the UART's registers are shadowed (eavesdropped) into the dual port RAM, enabling the 68HC11 
to indirectly observe a number of the UART's settings. It should be noted that this is a straight 
port-to-memory mapping, and that at present there is no address demultiplexing (as with the 6845 
register emulation). This means that the first two registers (base+0 and base+1) cannot be read 
reliably, as the user has no way of knowing whether those two addresses contain TxData and 
Interrupt settings or the Clock Divisor LSB and MSB respectively. This may change in future 
revisions. 
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Base Address i Shadow register Address 
COMI Oxd3f8-Oxd3ff 


Oxd2f8-Oxd2ff 


COM2 
Oxd2e8-Oxd2ef 


Figure 31: ISA COM port register shadowing 


5.3.3. Miscellaneous registers 


The ISA POST (Power On Self Test) register maps into the 68HC11’s address space at Oxd080. 
See also “3.1.8 - Last POST byte - p”. 
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6. Notes on the PC Weasel programming interface 
6.1 STDOUT/STDERR 


As previously stated in Section 2.1.3 "P2 - Local debug RS-232 port", the 68HC11's SCI (Serial 
Communication Interface) is employed as a debug port. This port is used as "stderr", eg 
fprintf(stderr, ...), etc. Writes to stderr are also logged in the msgbuf ring buffer and are available 
via the console. 


6.2 Weasel/OS Communication area 


The PC Weasel and the host operating system can communicate with one another using the (oth- 
erwise-unused) locations in the frame buffer between the end of viewable memory and the end of 
the frame buffer. This memory occupies OxbOfa0 through OxbOfff, and is utilized as follows: 


stuuct offscreen space { 


u_char wdt actvaton hame /* watchdog tmer actvaton */ 

stuuct config bbck cfg bbck copy; /* copy of config bbck */ 

u_charm oc cammand; /* mc command fem OS */ 

u_char m 5c response; /* yesponse to mc command */ 

u_char reserved [0336] ; /* reserved for fhitwe use */ 
}; 
wat activation han e: This is where the watchdog timer is initialized and queried. 
m Bc command This is where the PC sends a command to the weasel. 


Commands currently available are: 


0: OS READY PC Weasel is ready to receive a command or has written response. 


1:OS_UART CLEAR Direct PC Weasel to clear 16550 baud rate shadow register in 
preparation for OS UART_ QUERY. 


2:OS_ UART QUERY Query PC Weasel as to whether the 16550 baud rate register has 
been written. This provides a method by which the host OS can 
determine which 16550 present in the system belongs to the PC 
Weasel and thus which is the console port. The OS first sends an 
OS_UART_ CLEAR, configures its known serial ports’ baud 
rate registers, then sends an OS UART QUERY command. 
The PC Weasel will respond with a number in accordance with the 
following table: 


0 - UART not changed. ie: UART jumpers disabled. 
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1 - 0x3f8 modified. 
2 - 0x2f8 modified. 
3 - Ox3e8 modified. 
4 - 0x2e8 modified. 


3. OS CONFG COPY - Direct PC Weasel to copy its active configuration block to the 
offscreen space described above. Wniting this copy does not affect 
the PC Weasel's configuration. The configuration block is 
organized as follows: 


stuct config bbck { 

/* Version of conf */ 
u_char cfg verspn; 

/* Attenton character. ~6 defauk */ 
u_char weaseLatin; 

/* 0 == <BREAK> */ 

/* Debug Evel 0-1 for now */ 
u_char debug; 

/* veset PC on weasel boot */ 
u_char reset pc on boot; 

/* 300 1200 2400,....115200 230400 */ 
u_char duart baud; 

/* 0=none, 1= even, 2=odd */ 
u_char duart party; 

/* 7 or 8 */ 
u_char duart bits; 

/* 0O= always enubte1= albw swichng to sernk/ 
u_char enabb duart swichng; 

/* 0=dabb watchdog, 1= albw watchdag */ 
u_char wdt albw; 

/* Watchdog Timer reset timeout fm illsec) */ 
u_short wdtm sec; 

/* We ether do rts/cts fbw contolor nothng */ 
u_char duart fow; 

/* Do we pass breaks through tp 16550 or not */ 
u_char break passth; 

/* Obsobte */ 
char cbsobte BO]; 

/* aways Bst ebment. */ 
uchar cksum; 
} 


m ‘8c response: This is where the PC Weasel responds to misc_commands. 
reserved: Unused space. Reserved for future use. 


6.3 Watchdog Timer 


The PC Weasel provides a watchdog timer for host system monitoring. Once armed, the watch- 
dog ensures that the host's operating system periodically reads a value from a specified semaphore 
location in the framebuffer, ones-complement it, and write it back. If the OS fails to respond in 
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the allowed time, the host PC is reset (rebooted). (Note: The semaphore location is outside of 
viewable memory.) 


Arming and disarming the watchdog from the host system are identical operations in that the 
sequence is a toggle. 


vOBUB u_char *wdt san aphore; 
wdt semaphore = (@xb0000000 + @0*2*25) + 1); 
*wdt semaphore = 0x22; 
deky (1) ; 
 (wdt semaphore == Oxea) [ 
Awdt sem aphore = Ox2£; 
dey (1); 
 (®wdt semaphore == Oxae) { 
*wdt sem aphore = 0x37; 
deBy (1); 
wdtactve = “wit semaphow; 
/*1 = amed. 0 = deemed */ 
} 
} 


Servicing the watchdog: 


voBUB u char *wdt sem aphore; 
wdt sem aphore = (0xb0000000+ @0*2*25)+1); 
*wdt sem aphore “= *wdt sam aphore; 


Nn 
Les) 
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Appendix 1: Motorola S-Record Format 


Motorola Exorciser ("S-Record") format _ 


The Motorola Exorciser (commonly known as the "S-Record") format is a widely used format for 
the exchange of binary information as hexadecimal ASCII text. S-Records are output by the 
recommended toolchain for both the 68HC11 and the AVR (keyboard controller) and accepted by 
the various loaders used in the PC Weasel. We also supply firmware updates in this form. 


S-Records may begin with a sign-on record, which is initiated by the code "SO". Valid data 
records start with an 8-character prefix and end with a 2-character suffix. 


Each data record begins with the start characters "S1". The third and fourth characters represent 
the byte count, which expresses the number of data, address, and checksum bytes to follow in the 
record. The address of the first data byte in the record is expressed by the last 4 characters of the 


prefix. Data bytes follow, each represented by 2 hexadecimal characters. The number of data 
bytes occurring must be 3 less than the byte count. The suffix is a 2-character checksum. 


SO 
SIBCAAAAHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHCC 
S9BCAAAACC 

Sx: Start of record characters 
SO: Start of file 
S1: Start of data record 
S9: End of file 

BC: Byte count to follow in record 

AAAA: Address of first data byte in record 


HH: Hexadecimal data bytes (two-character pairs) 


cc: Checksum of record (one byte) 
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Appendix 2: Source Code License Agreement 


The PC Weasel source code is currently available under nondisclosure. Please contact us for 
further information. 
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Appendix 3: Manufacturers’ References 


68HC11 MCU: 


Motorola Semiconductor 

Technical Data 

MC68HC11A8 HCMOS Single-Chip Microcomputer 
Advance Information ADI1207R1 1987 

Order: MC68HC11A8/D 


Motorola Semiconductor 

M68HC11 HCMOS Single-Chip Microcomputer 
Programmer's Reference Manual 

First Edition 

Order: M68HC11PM/AD 


Motorola Semiconductor 
M68HC11 Reference Manual 
Order: M68HC11RM/AD 
ISBN 0-13-566720-8 


Motorola Semiconductor 

HC68HC11A8 HCMOS Single-Chip Computer 
Programming Reference Guide 

Order: MC68HC11A8RG/AD 


AVR: 


Atmel Corporation 

AT90S4433 

8-bit AVR Microcontroller with 2K/4K bytes In-System Programmable Flash 
Rev. 1042D-04/99 


DUART: 


Philips Semiconductor 

SC26C92 Dual universal asynchronous receiver/transmitter (DUART) 
Product specification 1998 Nov 09 

Supercedes data of 1998 Sep 04 

IC19 Data Handbook 


Exar Corporation 

XR88C92/192 Dual Universal Asynchronous Receiver and Transmitter 
Preliminary Information 

May 1998 
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UART: 


Exar Corporation 

ST16C550 UART with 16-byte FIFOs 

Rev 4.00 

1997 Data Communications Products Data Book 


FLASH: 


Advanced Micro Devices 

Am29F010A 

1 Megabit (128K x 8-bit) CMOS 5.0 Volt-only, 
Uniform Sector Flash Memory 

Publication# 22181 Rev: B Amendment/+1 
Issue Date: March 23, 1999 
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